home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Light ROM 1
/
LIGHT-ROM 1 (Amiga Library Services)(1994).iso
/
ffdisks
/
d918.lha
/
WBVerlauf
/
WBVerlauf.doc
< prev
next >
Wrap
Text File
|
1993-10-04
|
7KB
|
168 lines
WBVerlauf WBVerlauf
NAME
WBVerlauf - Create background copper list on the Workbench screen
LEGAL STUFF
Copyright ©1992, 1993 by Christian A. Weber, Zürich, Switzerland.
THIS PROGRAM AND ITS DOCUMENTATION MAY BE DISTRIBUTED FOR
NON-PROFIT PURPOSE ONLY. IT MAY NOT BE MODIFIED IN ANY WAY
WITHOUT THE PRIOR WRITTEN PERMISSION OF THE AUTHOR.
USE AT YOUR OWN RISK. NO WARRANTY. NO REFUNDS. NO CARRIER.
IT IS ILLEGAL TO DISTRIBUTE THIS PROGRAM ON DISKS WHICH COST
MORE THAN US $5 PER FLOPPY DISK, OR MORE THAN US $50 PER CD.
REQUIREMENTS
- Amiga with AGA chipset (currently A1200, A4000 and CD32)
- At least 68EC020 processor (as found in the A1200)
- Kickstart 3.0 or newer
- Color monitor :-)
INSTALLATION
To install WBVerlauf permanently in your system, just copy
the WBVerlauf program into your WBStartup drawer.
DESCRIPTION
WBVerlauf lets you create rainbow color effects for a selectable
pen color number on the Workbench screen, using the entire
16 million color range of the AGA chips.
You specify the color of the first and the last line of the screen,
and WBVerlauf will make a smooth color change by setting a new
color value on every scanline.
Example: I have an 8 color Workbench, and I set the Workbench's
background color to color 4 (using the WBPattern prefs
editor). Then I set the COLORNUMBER tooltype to 4, so
only the Workbench's color gets changed by WBVerlauf.
This looks very nice (the icon is designed for this case).
You can use the built-in configuration window to add or remove
color effects. A set of built-in effects is provided to get you
started quickly.
TOOLTYPES
WBVerlauf recognizes the following tooltypes, which can be
changed by clicking on the WBVerlauf icon and selecting
"Information..." from Workbench's "Icon"-menu:
Name Example Function
--------------------------------------------------------------
CX_POPKEY ctrl alt w Selects the key which will open
the configuration window
CX_POPUP Yes | No If set to Yes, the configuration
window will open whenever the
program is run.
CX_PRIORITY 0 Not very useful. Just ignore it.
COLORNUMBER 4 Pen number of the color to change.
A value of 0 means background color,
1 is normally the text color,
3 is for window borders, etc.
Must be in the range of 0 to 255.
STEP 4 Number of lines between color changes.
Defaults to 3. If you have a fast
processor, you may set this to 2 or 1,
which will look a tad better, but gives
slower screen dragging.
BORDERBLANK If this tooltype is present, WBVerlauf
will change the border color to black.
This is on by default.
RANDOMFX If present, WBVerlauf picks a random
effect out of your effect list rather
than using the active one.
EFFECT These are the effect entries. You should
use the configuration window to change
them, and not edit the tooltypes directly.
The effects are stored in the following format:
EFFECT <startcolor> <endcolor> <flags> <name>
startcolor - A six digit hexadecimal number specifying the
color of the first line of the screen. The first
two digits select the red level, the next two
digits the green and the last two digits the blue
level. So a startcolor of 0xF765E3 would give you
a nice pink (0xF7 for red, 0x65 for green and
0xE3 for blue; 00 is dark and FF is bright).
endcolor - A six digit hexadecimal number specifying the
color of the last line of the screen.
flags - Bit 0: If set, this effect is selected. Only one
effect may have this bit set at a time.
Bit 4: If set, 'startcolor' is ignored and a random
number is used as start color.
Bit 5: If set, 'endcolor' is ignored and a random
number is used as end color.
name - The name of the effect.
WARNINGS
This program makes use of undocumented hardware components of the
AGA chips, and is not programmed according to Commodore rules.
It will not work with future hardware or software versions.
You must NOT use this code in professional applications.
TODO
If you have any suggestions, let me know! Currently, I'm
planning to add the following for the next release:
- Random start- and ending colors can currently only be set
by directly editing tooltypes. The editor needs to support
this directly.
- Changing effects by hotkeys.
BUGS
Tell me about any you find!
AUTHOR
Christian A. Weber
Internet: weber@amiga.physik.unizh.ch, weber@pax.eunet.ch
UUCP: chris@mighty.adsp.sub.org
Snail mail: Bruggerweg 2, CH-8037 Zürich, Switzerland.
RELEASE NOTES
04-Aug-93 V2.0 - Sprite size change is faster
- Doesn't loop anymore, uses less CPU time
- WBVerlauf is now a commodity
- Configuration window added
- Localized to German and English
19-May-93 V1.9 - WBVerlauf no longer locks the WB screen, so
you can change screen modes while the
program is running.
05-Apr-93 V1.8 - Enforcer hit in copperlist routine removed
09-Mar-93 V1.7 - RANDOM parameter for colors added
15-Dec-92 V1.6 - Copper list optimized for better performance
07-Dec-92 V1.5 - Horizontal mouse pointer resolution change
works correctly (with a slight delay..)
- Colornumbers above 32 work correctly now
30-Nov-92 V1.4 Initial release